home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-1.iso / games / dcgames4.zip / UPDATE4.DOC < prev    next >
Text File  |  1995-10-02  |  9KB  |  251 lines
  1. DCGAMES 4.00
  2. Upgrade Instructions
  3.  
  4. If you have a game written using version 3.00 through 3.03 
  5. of DCGAMES, you will need to follow these steps to convert 
  6. it to the format used in version 4.00.
  7.  
  8. This document assumes that you have installed full 
  9. registered version of DCGAMES. The shareware product does 
  10. not include the utilites and compatibility files needed.  
  11.  
  12. It assumes that you have installed the product in the 
  13. directory DCGAMES, and the following directories:
  14.  
  15.   \DCGAMES\EXAMPLE    The new example game (version 4.0)
  16.   \DCGAMES\BIN        The common files (EXEs, etc)
  17.  
  18. 1.  First, make a backup copy of your game.
  19.  
  20.   C:\> mkdir OLDGAME
  21.   C:\> copy MYGAME\*.* OLDGAME
  22.   C:\> cd MYGAME
  23.   C:\MYGAME>
  24.  
  25. 2.  The next step is to Remove Obsolete Files that were 
  26. part of the old version.
  27.  
  28.   C:\MYGAME> del *.exe
  29.   C:\MYGAME> del sav*.*
  30.   C:\MYGAME> del party.dta
  31.   C:\MYGAME> del *.sco
  32.   
  33.   Note: you should not include the files PARTY.DTA or 
  34. SAV*.* with your game, so that it will start execution 
  35. from the beginning instead of from a saved position.
  36.  
  37. 3.  Now you have to upgrade your graphics images.  There 
  38. are 3 different ways of doing this depending on your 
  39. situation:
  40.  
  41.   a) If you have NOT created any new graphics images 
  42. using the DCBLOCK tile editor utility, you should just 
  43. delete the old tiles and use the backwards compatible 
  44. ones provided
  45.  
  46.   C:\MYGAME> del dcblocks.*
  47.   C:\MYGAME> del dcobject.*
  48.   C:\MYGAME> del dcpeople.*
  49.   C:\MYGAME> del dcsystem.*
  50.   C:\MYGAME> pkunzip \DCGAMES\BIN\OLDVHI.ZIP
  51.  
  52.   b) If you DID create your own graphics images using the 
  53. "VLO" graphics mode, you need to convert the images to 
  54. the new format and copy some new tiles over.  Note that 
  55. while VLO was the recommended and default graphics 
  56. mode, the VHI mode is now prefered.
  57.  
  58.   C:\MYGAME> rename dcblocks.VLO dcblock0.VLO
  59.   C:\MYGAME> dccnvt4g
  60.   C:\MYGAME> vgaremap VHI
  61.   C:\MYGAME> rename xx*.VHI dc*.VHI
  62.   C:\MYGAME> copy \DCGAMES\EXAMPLE\DCSYSTEM.VHI
  63.   
  64.   c) If you created your own graphics images using the 
  65. "VHI"graphics mode:
  66.  
  67.   C:\MYGAME> rename dcblocks.vhi dcblock0.vhi
  68.   C:\MYGAME> dccnvt4g
  69.   C:\MYGAME> copy \DCGAMES\EXAMPLE\dcsystem.vhi
  70.  
  71.   Note: You can use the XTRACT.EXE utility to copy 
  72. selected tiles if you want to upgrade your own 
  73. graphics.  For example:
  74.  
  75.   If you added landscaping tiles after the ones provided 
  76. by DCGAMES, you can overlay the original 84 tiles while 
  77. leaving yours intact as follows:
  78.  
  79.   C:\MYGAME> xtract -VHI \DCGAMES\EXAMPLE\dcblock0.vhi dcblock0.vhi 0 0 84
  80.  
  81. 4.  Now you convert the game files:
  82.  
  83.   Note: If you have accidentally created worlds that you 
  84. don't want (for example, if you created world # 600 
  85. when you intended to create world 60, this is your 
  86. chance to get rid of it.  Delete any WORLD.nnn and 
  87. WORLDO.nnn files that you don't want to keep before 
  88. running DCCNVT4 and the index file will be corrected to 
  89. reflect the actual number of worlds found.
  90.  
  91.   C:\MYGAME> del world.047
  92.   C:\MYGAME> del world.600
  93.   C:\MYGAME> dccnvt4 SAFE
  94.  
  95. 6.  The DCCTOKEN.DAT file changed quite a bit.  To know if 
  96. you can use the new one without any changes, you must 
  97. compare the DCCTOKEN.DAT file in your game with the 
  98. original file provided in version 3.03.
  99.  
  100.   C:\MYGAME> diff -v DCCTOKEN.DAT \DCGAMES\BIN\DCCTOKEN.303
  101.  
  102.   You will need to edit the NEW DCCTOKEN.DAT file and 
  103. make any changes that you made to the old file.  If you 
  104. added object classes and there is a conflict with the 
  105. ones I've added, you need to modify the list to match 
  106. YOUR settings.  Remember to re-compile the scripts and 
  107. also remember that the file \DCGAMES\BIN\DCOBJECT.VHI 
  108. contains tiles that are taged with the original object 
  109. class.  Thus, if you want to use those graphics you 
  110. will need to either use my original DCCTOKEN.DAT file 
  111. or use DCBLOCK.EXE to modify the object class in the 
  112. tiles.
  113.  
  114.   C:\MYGAME> copy \DCGAMES\BIN\dcctoken.dat
  115.   C:\MYGAME> edit dcctoken.dat       ! add my stuff
  116.  
  117. 6.  Now each script needs to be compared with the original 
  118. from version 3.03 to see if you changed it and the 
  119. changes must be made to the new scripts.
  120.  
  121.   If you didn't mess around with the scripts, just copy 
  122. them from the example directory:
  123.  
  124.   C:\MYGAME> copy \DCGAMES\EXAMPLE\*.SCR
  125.  
  126.   If you modified the original scripts, you can use you 
  127. should at least copy the following ones and use the 
  128. DIFF utility to compare the rest of them with your 
  129. modified ones and use a text editor to make any changes 
  130. manually:
  131.  
  132.   C:\MYGAME> copy \DCGAMES\OLDXMPL\CONTROL.SCR
  133.   C:\MYGAME> copy \DCGAMES\OLDXMPL\OBJECT.SCR
  134.   C:\MYGAME> copy \DCGAMES\OLDXMPL\CURRITEM.SCR
  135.   C:\MYGAME> copy \DCGAMES\OLDXMPL\DESCOBJ.SCR
  136.   C:\MYGAME> copy \DCGAMES\OLDXMPL\INITGAME.SCR
  137.   C:\MYGAME> copy \DCGAMES\OLDXMPL\FIGHTING.SCR
  138.  
  139.   Now compile all the scripts.
  140.   C:\MYGAME> for %i in (*.scr) do dcc %i
  141.  
  142.   The rest of the scripts didn't change too much.  I made 
  143. minor adjustments.  If you didn't modify them you 
  144. should copy mine.  Use the DIFF.EXE utility if you are 
  145. not sure.  All of your original scripts should work 
  146. without modification.
  147.  
  148. 8.  Finally, if you are going to use the VLO graphics mode, 
  149. you need to be aware that there is now a configurable 
  150. palette file that has a much better range of colors and 
  151. shades to be used in 256 color modes (.VLO,.VH1 
  152. and.VH2). The file DCPALET.PAL contains the palette in 
  153. NEOPAINT format and is loaded into the file DCPALET.DAT 
  154. using the LOADPAL.EXE utility.  If you have created 
  155. tiles in VLO or any of the superVGA resolutions, you 
  156. probably used the default VGA palette, so you need to 
  157. create your own DCPALET.DAT file as follows:
  158.  
  159.   C:\MYGAME> LOADPAL \DCGAMES\BIN\OLDPALET.PAL
  160.  
  161.   The file OLDPALET.PAL in \DCGAMES\BIN contains the VGA 
  162. default palette values 
  163.  
  164. 9.  If you had VOICE FILES (*.VFL) associated with your 
  165. game, you would need to convert them to the new format 
  166. as follows:
  167.  
  168.   C:\MYGAME> mkdir temp
  169.   C:\MYGAME> cd temp
  170.   C:\MYGAME\temp> unmkvfl ..\voice003.vfl
  171.   C:\MYGAME\temp> pack -P ..\voice003.rsc *.voc
  172.   C:\MYGAME\temp> del *.*
  173.  
  174.   Note: You would repeat the above for all VOICEnnn.VFL 
  175. files as well as the DCSOUNDS.VFL file.  You can now 
  176. delete the VFL file.  Make sure you have a backup just 
  177. in case.. :)
  178.  
  179.   NOTE: The only known bug is that you cannot use the 
  180. VOXKIT utility that Sound Blaster provides to compress 
  181. (or pack) the voices.  Packed voice files are not 
  182. supported.  Since the voices in the original example 
  183. ARE packed (to save a few bytes), I need to re-record 
  184. them!!
  185.  
  186. 10-  PCX graphics images
  187.  
  188. While your PCX files will work just fine as they are, 
  189. there are a few things you can do to make them better:
  190.  
  191. a)  DCGAMES will display PCX images inside the VIEW 
  192. window if they are small enough to fit.  Otherwise it 
  193. will clear the screen and display them on the full 
  194. screen.  In general, character and object pictures 
  195. should be kept small enough to fit in the VIEW 
  196. window, while world maps and other large images 
  197. should take up all of the screen (640x480 ideally).
  198.  
  199. b)  Note that DCGAMES has a standard palette of colors 
  200. that it works with.  Your PCX file also has a palette 
  201. and DCGAMES will try to use that palette to display 
  202. your graph.  There are several things you can do:
  203.  
  204. -  Use a paint program like NEOPAINT to change your 
  205. PCX images to use the DCGAMES palette.  This is the 
  206. best option.
  207.  
  208. -  Use 16 color images for your characters and 
  209. objects.  This allows the image to be displayed 
  210. very nicely in the VIEW window without changing the 
  211. color of the rest of the screen.
  212.  
  213. -  You may use 256 VLO mode (320x200) for full screen 
  214. images since the screen is cleared anyway, but even 
  215. with 16 colors the VHI resolution (640x480) can 
  216. display some very nice graphics due to the smaller 
  217. pixels.  A good paint program like NEOPAINT can use 
  218. dithering to create additional colors.
  219.  
  220.   In general, the best practice is to create separate PCX 
  221. files for the VLO and VHI resolutions if you want to 
  222. support both of them.  That way, your images will look 
  223. best in either format.  Your instllation of the game 
  224. should ask if they want to use VLO or VHI and install 
  225. the appropriate images.
  226.  
  227. You are now ready to edit and play your game using version 
  228. 4.00 of the game system.  Please call me after 9pm Central 
  229. any day (weekends or weekdays) if you have any questions. 
  230. If you start using the system a lot, you may want to make 
  231. notes and call when you have a list of questions.
  232.  
  233. If you are writing your own scripts, you should print the 
  234. CONTROL script and look it over!
  235.  
  236. I don't have any documentation yet except the Frequently 
  237. Asked Questions (FAQ) of which I've included a hard copy. 
  238. Thanks.
  239.  
  240. Enjoy,
  241.  
  242.  
  243.  
  244.  
  245.  
  246. Dave Hernandez
  247. 7908 Kettlewood Ct.
  248. Plano TX 75025
  249. 214-491-1579
  250.  
  251.